feat: add `debug_getRawHeader` method by natanasow · Pull Request #4926 · hiero-ledger/hiero-json-rpc-relay

natanasow · 2026-02-16T14:00:33Z

Description

Currently, we're missing the debug_getRawHeader method.

Solution

Implement debug_getRawHeader method
Check conformity tests
Edit openrpc.json and rpc-api.md
Add tests (if needed)

Missing fields in the Hedera concept:

fee_recipient

Address that receives transaction priority fees and MEV for the block
Set by the block proposer
Separates who proposes the block from who gets paid

prev_randao

On-chain randomness value from the Proof-of-Stake RANDAO
Used for validator selection and committee assignments
Represents accumulated randomness up to the previous step (not perfectly random)

withdrawal_root

Merkle root committing to all validator withdrawals in the block
Links consensus-layer withdrawals to execution-layer processing

RPC method:

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "debug_getRawHeader",
  "params": [
    "latest" // block number or block hash
  ]
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xf90211a0..." // RLP encoded header
}

Note:

fee_recipient - use 0.0.801 based on https://hips.hedera.com/hip/hip-1259
prevRandao - use block.difficulty - 0x0
withdrawal_root - use computed hash of an empty Trie object - 0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421

Related issue(s)

Fixes #4891

Testing Guide

Changes from original design (optional)

N/A

Additional work needed (optional)

N/A

Checklist

I've assigned an assignee to this PR and related issue(s) (if applicable)
I've assigned a label to this PR and related issue(s) (if applicable)
I've assigned a milestone to this PR and related issue(s) (if applicable)
I've updated documentation (code comments, README, etc. if applicable)
I've done sufficient testing (unit, integration, etc.)

Signed-off-by: nikolay <n.atanasow94@gmail.com>

# Conflicts: # packages/relay/src/lib/debug.ts

Signed-off-by: nikolay <n.atanasow94@gmail.com>

# Conflicts: # docs/rpc-api.md # scripts/openrpc-json-updater/config.js

Signed-off-by: nikolay <n.atanasow94@gmail.com>

github-actions · 2026-02-16T14:08:21Z

Test Results

0 tests ±0 0 ✅ ±0 0s ⏱️ ±0s
0 suites ±0 0 💤 ±0
0 files ±0 0 ❌ ±0

Results for commit 50b720b. ± Comparison against base commit c0f85f4.

♻️ This comment has been updated with latest results.

Signed-off-by: nikolay <n.atanasow94@gmail.com>

# Conflicts: # packages/relay/src/index.ts

…get-raw-header-method

Signed-off-by: nikolay <n.atanasow94@gmail.com>

jasuwienas

lgtm...

It’s unfortunate that we have to fetch all the transactions in a block just to return the header. However, as long as we’re responsible for calculating the root, I don’t think there’s any way around it.

Just few nits to consider (non-blockers I guess)

EDIT: but you'llhave to resolve the conflicts first.

packages/relay/src/lib/debug.ts

docs/openrpc.json

Signed-off-by: nikolay <n.atanasow94@gmail.com>

…get-raw-header-method # Conflicts: # packages/relay/src/lib/factories/blockFactory.ts # packages/server/tests/acceptance/debug.spec.ts

Signed-off-by: nikolay <n.atanasow94@gmail.com>

The base branch was changed.

# Conflicts: # docs/openrpc.json # docs/rpc-api.md # packages/relay/src/index.ts # packages/relay/src/lib/debug.ts # packages/relay/src/lib/factories/blockFactory.ts # packages/relay/tests/lib/debug.spec.ts # packages/server/tests/acceptance/debug.spec.ts # scripts/openrpc-json-updater/config.js

Signed-off-by: nikolay <n.atanasow94@gmail.com>

jasuwienas

lgtm

jasuwienas · 2026-02-20T14:17:11Z

packages/relay/src/lib/factories/blockFactory.ts

-  static rlpEncode(block: Block): Uint8Array {
-    if (typeof block.transactions[0] === 'string') {
+  static rlpEncode(block: Block, headerOnly: boolean = false): Uint8Array {
+    if (!headerOnly && typeof block.transactions[0] === 'string') {


It's not a blocker for me, but I think it would look a little bit cleaner with separate methods, and we wouldn’t need conditional validation logic here.

encodeHeader(block): RLP => rlp(header(block)); encode(block): RLP => validate(block) && rlp(...header(block), ...payload(block));

also because of this the jsdocs are not quite valid any longer (especiall ydescription of the returned value)

RLP encode a block based on Ethereum Yellow Paper. * @returns {Uint8Array} - RLP encoded block as Uint8 array

it should be more like

RLP encode a block (or its header only) based on Ethereum Yellow Paper. * @returns {Uint8Array} - RLP encoded block (or block header) as Uint8 array

BartoszSolkaBD

Looks good. I wonder if we should have better coverage for synthetic transactions in these debug methods. Please let me know what is your opinion.

BartoszSolkaBD · 2026-02-20T14:43:10Z

packages/relay/src/lib/factories/blockFactory.ts

   */
-  static rlpEncode(block: Block): Uint8Array {
-    if (typeof block.transactions[0] === 'string') {
+  static rlpEncode(block: Block, headerOnly: boolean = false): Uint8Array {


maybe we should split preparing canonical representation and encoding into two separate steps? I think it would allow us to get rid of headerOnly flag, swapping it for rlpEncodeBlock(block: Block) and rlpEncodeBlockHeader(header: BlockHeader)

Signed-off-by: nikolay <n.atanasow94@gmail.com>

codecov · 2026-02-21T14:32:57Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@            Coverage Diff             @@
##             main    #4926      +/-   ##
==========================================
+ Coverage   95.86%   95.97%   +0.10%     
==========================================
  Files         143      143              
  Lines       23968    24063      +95     
  Branches     1900     1910      +10     
==========================================
+ Hits        22977    23094     +117     
+ Misses        967      943      -24     
- Partials       24       26       +2

Flag	Coverage Δ
config-service	`98.63% <ø> (ø)`
relay	`92.38% <100.00%> (+0.20%)`	⬆️
server	`88.39% <ø> (ø)`
ws-server	`97.90% <ø> (ø)`

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
packages/relay/src/index.ts	`100.00% <100.00%> (ø)`
packages/relay/src/lib/debug.ts	`97.29% <100.00%> (-0.49%)`	⬇️
packages/relay/src/lib/factories/blockFactory.ts	`98.78% <100.00%> (+13.06%)`	⬆️

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

natanasow added 18 commits February 11, 2026 16:34

chore: add method

61a501b

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix comments

cc42633

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: format raw block

a36d6a3

Signed-off-by: nikolay <n.atanasow94@gmail.com>

Merge branch 'main' into 4890-add-debug-getrawblock-method

8107201

# Conflicts: # packages/relay/src/lib/debug.ts

chore: pull main

39b9123

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: add new lines

24bb813

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: pull main

18bbd8f

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix test

51ae109

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

6dc494a

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: remove ununsed import

08aadf3

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix padding

1737bce

Signed-off-by: nikolay <n.atanasow94@gmail.com>

Merge branch 'main' into 4890-add-debug-getrawblock-method

cbff76b

# Conflicts: # docs/rpc-api.md # scripts/openrpc-json-updater/config.js

chore: resolve comments

c25abea

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

a2aee36

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix mixhash

08db390

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix tests

e38b425

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: add method

744d5ab

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix test

db324a3

Signed-off-by: nikolay <n.atanasow94@gmail.com>

natanasow self-assigned this Feb 16, 2026

natanasow added the enhancement New feature or request label Feb 16, 2026

natanasow added this to the 0.76.0 milestone Feb 16, 2026

natanasow changed the base branch from main to 4890-add-debug-getrawblock-method February 16, 2026 14:01

natanasow added 5 commits February 17, 2026 10:25

chore: remove todo

c711078

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: add method to the interface

349eaee

Signed-off-by: nikolay <n.atanasow94@gmail.com>

Merge branch 'main' into 4890-add-debug-getrawblock-method

80d0d2a

# Conflicts: # packages/relay/src/index.ts

Merge branch '4890-add-debug-getrawblock-method' into 4891-add-debug-…

06130eb

…get-raw-header-method

chore: add method to the interface

6008b51

Signed-off-by: nikolay <n.atanasow94@gmail.com>

natanasow marked this pull request as ready for review February 17, 2026 13:54

natanasow requested a review from a team as a code owner February 17, 2026 13:54

natanasow added 5 commits February 18, 2026 11:11

chore: resolve comments

1e98c46

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

a05d094

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

f7d8a66

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: use mixhash instead of constant

84b9531

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix test

17afe77

Signed-off-by: nikolay <n.atanasow94@gmail.com>

jasuwienas previously approved these changes Feb 18, 2026

View reviewed changes

packages/relay/src/lib/debug.ts Outdated Show resolved Hide resolved

docs/openrpc.json Outdated Show resolved Hide resolved

natanasow added 6 commits February 18, 2026 16:42

chore: resolve comment

25cdb86

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

9656054

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: resolve comments

ac9fc4e

Signed-off-by: nikolay <n.atanasow94@gmail.com>

Merge branch 'main' into 4890-add-debug-getrawblock-method

2185dfa

Merge branch '4890-add-debug-getrawblock-method' into 4891-add-debug-…

2a8f1f3

…get-raw-header-method # Conflicts: # packages/relay/src/lib/factories/blockFactory.ts # packages/server/tests/acceptance/debug.spec.ts

chore: resolve comments

78279e8

Signed-off-by: nikolay <n.atanasow94@gmail.com>

natanasow requested review from BartoszSolkaBD and simzzz February 19, 2026 14:10

natanasow changed the base branch from 4890-add-debug-getrawblock-method to main February 19, 2026 17:38

natanasow added 5 commits February 19, 2026 19:48

chore: resolve conflicts

233a311

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix comment

55a4723

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: add tests

cd9baf8

Signed-off-by: nikolay <n.atanasow94@gmail.com>

chore: fix test

6903a5f

Signed-off-by: nikolay <n.atanasow94@gmail.com>

jasuwienas approved these changes Feb 20, 2026

View reviewed changes

simzzz approved these changes Feb 20, 2026

View reviewed changes

simzzz previously approved these changes Feb 20, 2026

View reviewed changes

jasuwienas previously approved these changes Feb 20, 2026

View reviewed changes

BartoszSolkaBD suggested changes Feb 20, 2026

View reviewed changes

chore: resolve comments

50b720b

Signed-off-by: nikolay <n.atanasow94@gmail.com>

natanasow dismissed stale reviews from jasuwienas and simzzz via 50b720b February 21, 2026 11:44

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

feat: add `debug_getRawHeader` method#4926

feat: add `debug_getRawHeader` method#4926
natanasow wants to merge 40 commits intomainfrom
4891-add-debug-get-raw-header-method

natanasow commented Feb 16, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 16, 2026 •

edited

Loading

Uh oh!

jasuwienas left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

jasuwienas left a comment

Uh oh!

jasuwienas Feb 20, 2026

Uh oh!

BartoszSolkaBD left a comment

Uh oh!

BartoszSolkaBD Feb 20, 2026

Uh oh!

codecov bot commented Feb 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Comments

Conversation

natanasow commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Solution

Missing fields in the Hedera concept:

Related issue(s)

Testing Guide

Changes from original design (optional)

Additional work needed (optional)

Checklist

Uh oh!

github-actions bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

jasuwienas left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

jasuwienas left a comment

Choose a reason for hiding this comment

Uh oh!

jasuwienas Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

BartoszSolkaBD left a comment

Choose a reason for hiding this comment

Uh oh!

BartoszSolkaBD Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

codecov bot commented Feb 21, 2026

Codecov Report

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

natanasow commented Feb 16, 2026 •

edited

Loading

github-actions bot commented Feb 16, 2026 •

edited

Loading

jasuwienas left a comment •

edited

Loading